home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pmem.z / pmem
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMEEEEMMMM((((1111))))                                                                PPPPMMMMEEEEMMMM((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmeeeemmmm - report per-process memory usage
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmeeeemmmm [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----nnnn _p_m_n_s_f_i_l_e] [----SSSS _s_e_c_o_n_d_s] [----uuuu _u_s_e_r_n_a_m_e] [----wwww]
  13.      [----zzzz] [----ZZZZ _t_i_m_e_z_o_n_e]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmeeeemmmm reports per-process memory usage statistics within the Performance
  17.      Co-Pilot framework.  Both virtual size and pro-rated physical memory
  18.      usage are reported.
  19.  
  20.      Unless directed to another host by the ----hhhh option, ppppmmmmeeeemmmm will contact the
  21.      PMCD (see ppppmmmmccccdddd(1)) on the local host to obtain the required information.
  22.      Alternatively, the ----aaaa option may be used to obtain the required
  23.      information from an archive (see ppppmmmmllllooooggggggggeeeerrrr(1)).  If the ----aaaa option is used,
  24.      then the ----SSSS option may be used to specify the temporal position relative
  25.      to the start of the archive in seconds.
  26.  
  27.      The ----uuuu option restricts the report to the specified _u_s_e_r_n_a_m_e on the
  28.      target host or archive.  Normally the report is truncated at the 80th
  29.      column.  This is over-ridden with the ----wwww option.
  30.  
  31.      By default, ppppmmmmeeeemmmm reports the time of day according to the local timezone
  32.      on the system where ppppmmmmeeeemmmm is run.  The ----ZZZZ option changes the timezone to
  33.      _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as described in
  34.      eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the timezone to the local timezone at
  35.      the host that is the source of the performance metrics, as identified via
  36.      either the ----hhhh or ----aaaa options.
  37.  
  38.      Normally ppppmmmmeeeemmmm operates on the default Performance Metrics Namespace
  39.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  40.      loaded from the file _p_m_n_s_f_i_l_e.
  41.  
  42. RRRREEEEPPPPOOOORRRRTTTT FFFFOOOORRRRMMMMAAAATTTT
  43.      In the report, all sizes are reported in Kbytes unless shown with an MMMM
  44.      suffix, in which case the size is Mbytes (multiples of 1048576 bytes).
  45.      The virtual memory usage statistics represent the total virtual size of
  46.      each process, irrespective of how many pages are valid (resident).  The
  47.      physical memory statistics indicate real memory usage (only valid pages
  48.      are counted) and are pro-rated on a per-page basis between all processes
  49.      which reference each page.
  50.  
  51.      The columns in the report should be interpreted as follows:
  52.  
  53.      ppppiiiidddd       Process id.
  54.  
  55.      ppppppppiiiidddd      Parent process id.
  56.  
  57.      uuuusssseeeerrrrnnnnaaaammmmeeee  User name of process owner.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMEEEEMMMM((((1111))))                                                                PPPPMMMMEEEEMMMM((((1111))))
  71.  
  72.  
  73.  
  74.      vvvvttttxxxxtttt      Total virtual memory used by text (executable code) regions
  75.                mapped by the process.
  76.  
  77.      ppppttttxxxxtttt      Pro-rated physical memory used by text regions.
  78.  
  79.      vvvvddddaaaatttt      Total virtual memory used by all non-executable regions,
  80.                excluding shared memory regions.  This includes initialized
  81.                data, bss and stack but not shared memory regions.
  82.  
  83.      ppppddddaaaatttt      Pro-rated physical memory used by all data regions (data, bss
  84.                and stack but not shared memory regions).
  85.  
  86.      vvvvsssshhhhmmmm      Total virtual memory used by all shared memory regions.
  87.  
  88.      ppppsssshhhhmmmm      Pro-rated physical memory used by shared memory regions.
  89.  
  90.      ccccoooommmmmmmmaaaannnndddd   The command and arguments, truncated so each line in the report
  91.                is at most 80 columns (unless the ----wwww option is given).
  92.  
  93.      The report heading shows the amount of physical memory configured on the
  94.      target host and the amount of free memory, as reported by the operating
  95.      system (see the PCP metric iiiirrrriiiixxxx....mmmmeeeemmmm....ffffrrrreeeeeeeemmmmeeeemmmm).
  96.  
  97.      Only memory used in user space is counted - memory used in kernel tables
  98.      such as that used for pppptttteeees (page table entries), and the pppprrrroooocccc and uuuusssseeeerrrr
  99.      structures are not counted because they are allocated in the kernel's
  100.      address space.
  101.  
  102.      At the end of the report, a summary is printed indicating the totals for
  103.      each column and the grand totals.  The difference between the total
  104.      physical memory in use by all processes and the total configured physical
  105.      memory will always be more than the free memory reported by the operating
  106.      system because the latter also accounts for memory allocated in the
  107.      kernels address space.
  108.  
  109.      All statistics are accurate to within one 256th of a page (16 bytes on
  110.      IRIX 5.3 systems).
  111.  
  112. FFFFIIIILLLLEEEESSSS
  113.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  114.  
  115. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  116.      ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmvvvvaaaallll(1), and
  117.      sssspppprrrroooocccc(2).
  118.  
  119. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  120.      All are generated on standard error and are intended to be self-
  121.      explanatory.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.